系统动作

用于管理系统属性。

重新启动

重启 runtime。

保存趋势

将历史趋势数据保存到外部驱动器（USB驱动器或SD卡）。

参数 说明
TrendName 要存储的历史趋势名称
FolderPath

目标文件夹：

  • 内存 = \闪存\QTHMI\工作空间\转储
  • USB驱动器=\USB存储
  • SD 卡 = \存储卡
  • 公共网 = \\<主机名或 IP>\共享路径
  • 专用网络 = \\<用户名>:<密码>@<主机名或 IP>\sharePath

注：支持的外部存储器格式为 FAT 或 FAT32（不支持 NTFS 格式）。

注：只有配备 BSP 1.0.25 及更高版本的 Linux 设备才支持专用网。

FileFormat

Binary = 缓存以二进制格式转储（.dat 文件和 .inf 文件）。这些文件都要求用外置应用以.csv格式转换数据。

Compatibility CSV = 缓存以兼容版本 1.xx 的 .csv 文件格式转储到指定位置

Compact CSV = 缓存使用更新格式以 .csv 文件转储至指定位置

参见 "导出趋势缓存数据"

DateTimePrefix

true = 保存的文件的名称将以日期和时间作为词头 （例如 D2012_01_01_T10_10_Trend1.csv）

时间格式

时间格式：

  • Local = 输出的时间值是 HMI 设备上的时间。
  • Global = 输出的时间值以 UTC 格式。
文件名

当 DateTimePrefixFileName=true 时启用

支持以下通配符

  • %n = 趋势名称
  • %y = 年
  • %M = 月
  • %d = 日
  • %h = 小时
  • %m = 分钟
  • %s = 秒

示例：\%n\%y%M%d\%h%m%s

仅在所选文件格式为紧凑 CSV 时才可用的附加参数

当“选择字段”和“选择曲线”参数都为空时，.csv 文件将以旧的“紧凑 CSV”而非列选择格式转储。另请参阅"导出趋势缓存数据"

参数 说明
选择字段

选择转储文件内要导出的列。

可用列如下：

  • DateTime
  • Date
  • Time
  • Value
  • Quality

请注意，“附加到标签”可用于定义在运行时从 HMI 应用程序导出的列。该标签必须包含一个字符串，其中包含要导出并用逗号分隔的字段列表。

示例：

  • ""（空字符串 = 所有可用字段）
  • "DateTime,Value,Quality"
  • "Date,Time,Value"
选择曲线

选择转储文件内要导出的曲线

请注意，“附加到标签”可用于定义在运行时从 HMI 应用程序导出的曲线。该标签必须包含一个字符串，其中包含要导出并用逗号分隔的曲线名称列表。

示例：

  • 空字符串或“所有曲线”将导出所有数据集
  • "Name1,Name2,Name3"
  • "Name1,Name3"
日期格式

选择日期和时间格式

使用“附加到标签”可以在运行时通过字符串定义日期格式

日期占位符
d 不带前导零的天数（1 至 31）
dd 带前导零的天数（01 至 31）
ddd 缩写的本地化日期名称（例如，“周一”至“周日”）
dddd 较长的本地化日期名称（例如，“周一”至“周日”）。
M 不带前导零的月份数 (1-12)
MM 带前导零的月份数 (01-12)
MMM 缩写的本地化月份名称（例如，“一月”至“十二月”）。
MMMM 较长的本地化月份名称（例如，“一月”至“十二月”）。
yy 以两位数表示的年份 (00-99)
yyyy 以四位数表示的年份
时间占位符
h 不带前导零的小时数（如果显示上午/下午，0 至 23 或 1 至 12）
hh 带前导零的小时数（如果显示上午/下午，00 至 23 或 01 至 12）
m 不带前导零的分钟数（0 至 59）
mm 带前导零的分钟数（00 至 59）
s 不带前导零的秒数（0 至 59）
ss 带前导零的秒数（00 至 59）
zzz 带前导零的毫秒数
z 毫秒
AP 使用上午/下午显示。AP 将替换为“上午”或“下午”。
AP 使用上午/下午显示。AP 将替换为“上午”或“下午”。
语言

选择要使用的语言。

注：保存趋势　(DumpTrend) 动作的执行将自动强制暂时保存在 RAM 存储器上的数据盘。查看"历史趋势控件"了解如何保存样本数据到磁盘。

注：连接到 USB 端口的外部驱动器必须有 FAT 或 FAT32格式。NTFS 格式不支持。

警告：在一个文件夹内可以创建的最大文件数存在限制。具体限制取决于不同因素，不能简单地进行计算，您可以认为 999 是在文件夹内可以创建的最大文件数。

将二进制转储文件转化为 .csv 格式

TrendBufferReader.exe 工具存储在 JMobile Studio 安装文件夹的 Utils 文件夹中。

使用以下句法：

TrendBufferReader -r Trend1 Trend1.csv 1

其中：

Trend1 = 没有因为保存而产生扩展名的趋势缓存名称(原始文件名是 trend1.dat)

Trend1.csv = 输出文件的名称。

警告：TrendBufferReader.exe 是一个旧的实用工具，不适用于新的多标签缓冲区。不建议使用该实用工具。由于现在可以直接转储 .csv 格式的趋势缓存数据，因此该实用工具无需更多维护。

.csv 文件结构

形成的 .csv 文件有五栏

栏 说明
Data Type

样本标签的数据类型：

0 = empty

1 = boolean

2 = byte

3 = short

4 = int

5 = unsignedByte

6 = unsignedShort

7 = unsignedInt

8 = float

9 = double
Value

样本的值
Timestamp(UTC)

时间戳以UTC格式
Sampling Time(ms)

样本间隔时间以毫秒表示
Quality

标签值质量。根据 OPC DA 标准编码的信息以及存储在字节数据中以（8位）三位域形式的信息；Quality、Sub 状态和 Limit 状态。

八质量位按如下排列：QQSSSSLL。需要所有单一域的完整和详细描述，请查看 OPC DA 官方文件。
常用质量值

HMI 获取引擎返回的最常用的质量值是：

质量编码

质量

说明

0

坏

该值不好但没有具体原因

4

坏

配置的具体服务器问题。例如：标签已从配置文件 (tags.xml) 被删除。

8

坏

此时可能没有可用的值，例如：数据来源没有提供值。

12

坏

检测到设备失败

16

坏

设备反应之前已过期。

24

坏

通信失败

28

坏

没有找到更高或更低的绑定值的趋势界面特定标签的数据。

32

坏

未收集数据（例如：存档未激活）。

趋势界面特定记号。

该值用于指示暂时的离线状态（针对任何取样停止的情况）。

64

不确定

无具体原因。

65

不确定

无具体原因。

该值在某个更低的限制下被固定。

66

不确定

无具体原因。

该值在某个更高的限制下被固定。

67

不确定

无具体原因。

该值是恒量，不能移动。

84

不确定

在其限定的限制以外的返回值。

此时限制字段指示哪个限制被超过了，但这个值可以移动到这个范围外。

85

不确定

在其限定的限制以外的返回值。

此时限制字段指示哪个限制被超过了，但这个值可以移动到这个范围外。

该值在某个更低的限制下被固定。

86

不确定

在其限定的限制以外的返回值。

此时限制字段指示哪个限制被超过了，但这个值可以移动到这个范围外。

该值在某个更高的限制下被固定

87

不确定

在其限定的限制以外的返回值。

此时限制字段指示哪个限制被超过了，但这个值可以移动到这个范围外。

该值是恒量，不能移动。

192

好

-
删除趋势

删除保存的趋势数据。

定义您要删除记录的趋势名称。

保存事件存档

保存历史报警记录和日志跟踪数据存储到外部驱动器，如 USB 闪存或 SD 卡。

参数 说明
EventArchive 存储数据的缓存名称
FolderPath

目标文件夹

  • 内存 = \闪存\QTHMI\工作空间\转储
  • USB驱动器=\USB存储
  • SD 卡 = \存储卡
  • 公共网 = \\<主机名或 IP>\共享路径
  • 专用网络 = \\<用户名>:<密码>@<主机名或 IP>\sharePath

注：支持的外部存储器格式为 FAT 或 FAT32（不支持 NTFS 格式）。

注：只有配备 BSP 1.0.25 及更高版本的 Linux 设备才支持专用网。
DumpConfigFile 转储存档的描述文件
DumpAsCSV

true = 缓存作为 .csv 文件存储到指定位置

false = 缓存以二进制格式转储（.dat 文件和 .inf 文件）。这些文件都要求用外置应用以.csv格式转换数据。
DateTimePrefix

true = 保存的文件的名称将以日期和时间作为词头 （例如 D2012_01_01_T10_10_alarmBuffer1.csv）
timeSpec

时间格式：

  • Local = 输出的时间值是 HMI 设备上的时间。
  • Global = 输出的时间值以 UTC 格式。
csv 列

选择要转储到 .csv 文件中的列。

仅当 EventArchive 为报警缓存时才适用
文件名

支持以下通配符

  • %n = 事件存档名称
  • %y = 年
  • %M = 月
  • %d = 日
  • %h = 小时
  • %m = 分钟
  • %s = 秒

示例：\%n\%y%M%d\%h%m%s

仅当 DateTimePrefixFileName=true 时才适用
语言

选择要使用的语言。

仅当 EventArchive 为报警缓存时才适用
单独的日期和时间 启用时，日期和时间列在单独的列中。
日期格式 选择预定义的格式或者使用占位符定义您自己的格式（请参阅"时间和日期占位符"）
以 CSV 格式转储

DumpAsCSV = true

对于报警缓存，附加“csv 列”参数可以选择要在 .csv 文件中导出的列

注：只对报警缓存可用。

以二进制格式转储

DumpAsCSV = false

导出采用二进制格式的事件缓存且 DumpConfigFile 设为 true（推荐设置）时，有两个文件夹：

一旦这两个文件夹从 USB 驱动复制到计算机磁盘中，文件夹结构会是：

\config\

alarms.xml

eventconfig.xml

\data\

AlarmBuffer1.dat

AlarmBuffer1.inf

\

AlarmBufferReader.exe

将存储的文件转化为 .csv 格式

AlarmBufferReader.exe 工具存储在 JMobile Studio 安装文件夹的 Utils 文件夹中。

使用以下句法：

AlarmBufferReader AlarmBuffer1 FILE ./AlarmBuffer1.csv

其中：

应用程序 AuditTrailBufferReader.exe 对检测尝试缓存可用。

使用以下句法：

AuditTrailBufferReader AuditTrail FILE ./AuditTrail.csv

其中：

警告：AlarmBufferReader.exe 是一个旧的实用工具，不适用于更新的缓冲区格式。不建议使用该实用工具。由于现在可以直接转储 .csv 格式的报警缓存数据，因此该实用工具无需更多维护。

DeleteEventArchive

删除保存的事件缓存记录数据。

指定要从事件记录中删除的事件缓存的名称。

ResetProtoErrCount

复位协议错误计数系统变量。

请参阅"系统变量（附加至）"了解详细信息。

SafelyRemoveMedia

提供从 HMI 安全的移除 SD 卡或 USB 驱动。

CopyCodesysProject

CODESYS 2.3 项目文件 (.prg、chk 和 .sdb)从源路径复制到设备CODESYS文件夹。

文件按需要自动被重命名为 DEFAULT.CHK , DEFAULT.PRG , BOOT.SDB 。 

之后复制 CODESYS 模块被停止，重新加载和重新开始。

参数 说明
源路径 进入外部存储的项目路径（例如： \USB存储\Codesys）
复制符号 true = 按照 CODESYS 2 ETH 协议的要求复制 .sdb 符号文件
生成 CODESYS 项目文件
  1. 运行项目 > 重建所有：将生成一个已更新 .sdb 符号文件。
  2. 运行在线 > 创建启动项目：将生成 .chk 与 .prg 文件。

该动作可以用于 HMI 设备之间传输 CODESYS 项目。在这种情况下，从 HMI 运行的 CODESYS 项目复制这些文件：

使用以下 PLC 系统变量验证 PLC 和复制Codesys项目动作状态：

控制用户LED

设置用户LED行为。

Linux 平台上不可用（在 "HMI 设备地址"寻找您的设备平台）

保存事件存档

将位于日志中的记录导出到签名文件。该文件签名将确保报告中的记录不会更改。

参数 说明
EventArchive 存储数据的缓存名称
FolderPath

目标文件夹

  • 内存 = \闪存\QTHMI\工作空间\转储
  • USB驱动器=\USB存储
  • SD 卡 = \存储卡
  • 公共网 = \\<主机名或 IP>\共享路径
  • 专用网络 = \\<用户名>:<密码>@<主机名或 IP>\sharePath

注：支持的外部存储器格式为 FAT 或 FAT32（不支持 NTFS 格式）。

注：只有配备 BSP 1.0.25 及更高版本的 Linux 设备才支持专用网。
文件名

支持以下通配符

  • %n = 事件存档名称
  • %y = 年
  • %M = 月
  • %d = 日
  • %h = 小时
  • %m = 分钟
  • %s = 秒

示例：\%n\%y%M%d\%h%m%s
格式化

输出文件的格式

  • CSV
已签名

生成文件签名。

在 Linux 设备上需要 BSP v1.0.239 或更高版本

在项目属性参数中定义用于签名的算法
请参阅"项目"了解可用算法

另请参阅：
时间格式

时间格式：

  • Local = 输出的时间值是 HMI 设备上的时间。
  • Global = 输出的时间值以 UTC 格式。
PeriodMode

定义要导出的时间窗口

  • 所有事件
  • 今天
  • 昨天
  • 上周
  • 上月
  • 本周
  • 本月
  • 自定义
    将显示附加参数“periodFrom”和“periodTo”
单独的日期和时间

使用两个单独的日期和时间列
日期格式

选择日期和时间格式

签名文件

当“签名文件”参数为 true 时，除 fileame.csv 格式之外还将添加两个文件：

有关该证书以及如何验证签名文件的更多信息，请参阅"X.509 证书"。

有关导出信息的更多信息，请参阅"导出日志到．csv文件"。

日志消息

将消息添加到日志缓冲区中。

通过该宏，开发人员可以决定跟踪日志中的一些事件（例如，按下按钮、激活页面时）。通过附加到标签，支持在运行时定义要记录的消息。

参数 说明
EventArchive 添加消息所在的日志缓冲区的名称
消息

要在日志缓冲区中添加的消息
删除旧文件

该宏可删除给定天数的旧文件。

在 PC 中，没有路径使用限制。在面板中，允许在动态媒体和数据分区中使用 以及 Linux 中的）

开发人员负责配置该应用程序以免删除系统文件。

参数 说明
FolderPath 搜索要删除的文件所在的文件夹
文件类型

要删除的文件列表，用逗号分隔。支持通配符

示例：*.png,*.jpg
之前日期

最小天数（无更改）